Tooling > TypeScript Support #53

nozomuikuta · 2020-09-16T20:13:51Z

resolves #41

kazupon

レビュー 👀 してコメント 💬 しました。
確認お願いします！ 🙏

kazupon · 2020-09-19T16:13:29Z

src/guide/typescript-support.md


-For developing Vue applications with TypeScript, we strongly recommend using [Visual Studio Code](https://code.visualstudio.com/), which provides great out-of-the-box support for TypeScript. If you are using [single-file components](./single-file-components.html) (SFCs), get the awesome [Vetur extension](https://github.com/vuejs/vetur), which provides TypeScript inference inside SFCs and many other great features.
+TypeScript による Vue アプリケーションの開発のために、すぐに利用できる TypeScript サポートを提供している [Visual Studio Code](https://code.visualstudio.com/) を強く推奨します。[シングルファイルコンポーネント](./single-file-components.html) (SFCs) を使用している場合、SFC 内部での TypeScript の推論やその他の優れた機能を提供している、素晴らしい素晴らしい [Vetur エクステンション](https://github.com/vuejs/vetur) を入手してください。


シングルファイルコンポーネント は 単一ファイルコンポーネント でお願いします。現時点で日本語公式ドキュメントはそのように訳して統一しているので。

あと、awesome の訳は(多分typo?) 素晴らしい にしておきました。

Suggested change

TypeScript による Vue アプリケーションの開発のために、すぐに利用できる TypeScript サポートを提供している [Visual Studio Code](https://code.visualstudio.com/) を強く推奨します。[シングルファイルコンポーネント](./single-file-components.html) (SFCs) を使用している場合、SFC 内部での TypeScript の推論やその他の優れた機能を提供している、素晴らしい素晴らしい [Vetur エクステンション](https://github.com/vuejs/vetur) を入手してください。

TypeScript による Vue アプリケーションの開発のために、すぐに利用できる TypeScript サポートを提供している [Visual Studio Code](https://code.visualstudio.com/) を強く推奨します。[単一ファイルコンポーネント](./single-file-components.html) (SFCs) を使用している場合、SFC 内部での TypeScript の推論やその他の優れた機能を提供している、素晴らしい [Vetur エクステンション](https://github.com/vuejs/vetur) を入手してください。

kazupon · 2020-09-19T16:21:16Z

src/guide/typescript-support.md

  }
 })
 ```

-If you have a complex type or interface, you can cast it using [type assertion](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions):
+複雑な型や推論の場合、[タイプアサーション](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:


技術用語は、カタカナ日本語で訳す場合は、以下のように原文の技術用語の載せてください！ 🙏
(載せておくことで技術用語が翻訳されて意味が分からない人のためにも、原文を残して置くことによって理解できるようにしておくためです。)

Suggested change

複雑な型や推論の場合、[タイプアサーション](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:

複雑な型や推論の場合、[タイプアサーション (type assertions)](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:

kazupon · 2020-09-19T16:35:13Z

src/guide/typescript-support.md


-## Using with Composition API
+## コンポジション API とともに使用する


@potato4d
翻訳方針として v2 のときのガイドラインに従う形なんですが、Compostion APIという技術用語、カタカナ日本語でとりあえず、訳す方向にします？

個人的にはカタカナ日本語に訳すのは、あまり意味がない(読み方が分かる程度)のと、訳してかえってわかりにくくなるとという過去の経験から、今後としては技術用語は、原文のままとしておきたいです。

@potato4d

個人的にはカタカナ日本語に訳すのは、あまり意味がない(読み方が分かる程度)のと、訳してかえってわかりにくくなるとという過去の経験から、今後としては技術用語は、原文のままとしておきたいです。

ここで、途中から、このような形にしてしまうと、これまでの翻訳形式と一貫性がなくなってしまうので、引き続き訳すという方向で行きたいと思います。

kazupon · 2020-09-19T16:37:47Z

src/guide/typescript-support.md

@@ -140,9 +140,9 @@ const Component = defineComponent({
 })
 ```

-### Annotating Props
+### プロパティにアノテーションをつける


ここは、プロパティ に訳さず、 Props のままとしてください。 🙏
Props としておくことで、Vue コンポーネントの props というのが読み手の分かりやすいので。

Suggested change

### プロパティにアノテーションをつける

### Props にアノテーションをつける

kazupon · 2020-09-19T16:39:43Z

src/guide/typescript-support.md

-    const result = props.message.split('') // correct, 'message' is typed as a string
-    const filtered = props.message.filter(p => p.value) // an error will be thrown: Property 'filter' does not exist on type 'string'
+    const result = props.message.split('') // 正しいです, 'message' は文字列 (string) として型づけされます
+    const filtered = props.message.filter(p => p.value) // エラーが起こります: 'filter' プロパティは文字列 (string) 型には存在しません。


Property 'filter' does not exist on type 'string' は TypeScript のコンパイラのエラーだと思うので、もしそうならば、訳さずそのままにしておきたいです。

kazupon · 2020-09-19T16:40:41Z

src/guide/typescript-support.md

@@ -206,25 +208,28 @@ const Component = defineComponent({
    const year = ref(2020)

    const result = year.value.split('') // => Property 'split' does not exist on type 'number'
+    const result = year.value.split('') // => 'split' プロパティは 'number' 型に存在しません


ここの、Property 'split' does not exist on type 'number' も同じく、TypeScript のコンパイラのエラーだと思うので、もしそうならば、訳さずそのままにしておきたいです。

kazupon · 2020-09-19T16:41:45Z

src/guide/typescript-support.md

    const doubleCount = computed(() => count.value * 2)

-    const result = doubleCount.value.split('') // => Property 'split' does not exist on type 'number'
+    const result = doubleCount.value.split('') // => 'split' プロパティは 'number' 型に存在しません。


Property 'split' does not exist on type 'number' も同じく、TypeScript のコンパイラのエラーだと思うので、もしそうならば、訳さずそのままにしておきたいです。

kazupon · 2020-09-19T16:43:03Z

src/guide/typescript-support.md

@@ -258,10 +263,10 @@ export default defineComponent({
  setup() {
    let count = ref(0)

-    // read-only
+    // リードオンリー


訳すならば、以下のような感じですね。

Suggested change

// リードオンリー

// 読み取り専用

netlify · 2020-09-20T12:10:56Z

Deploy preview for vuejs-v3-ja-doc-preview ready!

Built with commit ab84ef5

https://deploy-preview-53--vuejs-v3-ja-doc-preview.netlify.app

nozomuikuta

@kazupon

レビューありがとうございます！
ご指摘の部分は、「Composition API」の部分を除いて修正されたと思います。

nozomuikuta · 2020-09-20T12:12:24Z

src/guide/typescript-support.md

@@ -86,7 +86,7 @@ const Component = defineComponent({
 })
 ```

-複雑な型や推論の場合、[タイプアサーション](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:
+複雑な型や推論の場合、[タイプアサーション (type assertion)](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:


こちら、原文の通り「type assertion」（単数形）を併記しました。

nozomuikuta · 2020-09-20T12:13:14Z

src/guide/typescript-support.md

@@ -190,7 +190,7 @@ const Component = defineComponent({

  setup(props) {
    const result = props.message.split('') // 正しいです, 'message' は文字列 (string) として型づけされます
-    const filtered = props.message.filter(p => p.value) // エラーが起こります: 'filter' プロパティは文字列 (string) 型には存在しません。
+    const filtered = props.message.filter(p => p.value) // エラーが起こります: Property 'filter' does not exist on type 'string'


こちら、TypeScriptのエラーメッセージのようですので、原文に戻しました。

nozomuikuta · 2020-09-20T12:14:00Z

src/guide/typescript-support.md

@@ -208,7 +208,6 @@ const Component = defineComponent({
    const year = ref(2020)

    const result = year.value.split('') // => Property 'split' does not exist on type 'number'
-    const result = year.value.split('') // => 'split' プロパティは 'number' 型に存在しません


こちら、TypeScriptのエラーメッセージのようですので、原文に戻しました。
また、翻訳の際に文を複製したものが残っていたため、削除しました。

nozomuikuta · 2020-09-20T12:14:14Z

src/guide/typescript-support.md

    const doubleCount = computed(() => count.value * 2)

-    const result = doubleCount.value.split('') // => 'split' プロパティは 'number' 型に存在しません。
+    const result = doubleCount.value.split('') // Property 'split' does not exist on type 'number'


こちら、TypeScriptのエラーメッセージのようですので、原文に戻しました。

kazupon · 2020-09-20T18:07:34Z

@nozomuikuta
Composition API については、訳す方向にしたいと思います。
現状翻訳しているので、その内容を取り込みたいと思います。

kazupon · 2020-09-20T18:12:36Z

CIでエラー起きているが、これは review-alert-box ラベルがないから起きている感じ。
このエラーは特に支障をきたさないので、マージする。

kazupon · 2020-09-20T18:13:27Z

翻訳ありがとうございました！

pr-triage bot added the PR: unreviewed label Sep 16, 2020

kazupon requested changes Sep 19, 2020

View reviewed changes

pr-triage bot added PR: reviewed-changes-requested and removed PR: unreviewed labels Sep 19, 2020

nozomuikuta added 2 commits September 20, 2020 21:08

feat: translate typescript support page into japanese

e873074

fix: apply feedback

ab84ef5

nozomuikuta force-pushed the typescript-support branch from 100321d to ab84ef5 Compare September 20, 2020 12:09

pr-triage bot added PR: unreviewed and removed PR: reviewed-changes-requested labels Sep 20, 2020

nozomuikuta commented Sep 20, 2020

View reviewed changes

kazupon approved these changes Sep 20, 2020

View reviewed changes

pr-triage bot added PR: reviewed-approved and removed PR: unreviewed labels Sep 20, 2020

kazupon merged commit 66a9801 into vuejs-jp:lang-ja Sep 20, 2020

pr-triage bot added PR: merged and removed PR: reviewed-approved labels Sep 20, 2020

nozomuikuta mentioned this pull request Sep 21, 2020

Tooling > TypeScript Support #73

Merged


		For developing Vue applications with TypeScript, we strongly recommend using [Visual Studio Code](https://code.visualstudio.com/), which provides great out-of-the-box support for TypeScript. If you are using [single-file components](./single-file-components.html) (SFCs), get the awesome [Vetur extension](https://github.com/vuejs/vetur), which provides TypeScript inference inside SFCs and many other great features.
		TypeScript による Vue アプリケーションの開発のために、すぐに利用できる TypeScript サポートを提供している [Visual Studio Code](https://code.visualstudio.com/) を強く推奨します。[シングルファイルコンポーネント](./single-file-components.html) (SFCs) を使用している場合、SFC 内部での TypeScript の推論やその他の優れた機能を提供している、素晴らしい素晴らしい [Vetur エクステンション](https://github.com/vuejs/vetur) を入手してください。

	複雑な型や推論の場合、[タイプアサーション](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:
	複雑な型や推論の場合、[タイプアサーション (type assertions)](https://www.typescriptlang.org/docs/handbook/basic-types.html#type-assertions) を使用してキャストすることができます:


		## Using with Composition API
		## コンポジション API とともに使用する

	### プロパティにアノテーションをつける
	### Props にアノテーションをつける

Tooling > TypeScript Support #53

Tooling > TypeScript Support #53

Uh oh!

Conversation

nozomuikuta commented Sep 16, 2020

Uh oh!

kazupon left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

netlify bot commented Sep 20, 2020

Uh oh!

nozomuikuta left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

kazupon commented Sep 20, 2020

Uh oh!

kazupon commented Sep 20, 2020

Uh oh!

kazupon commented Sep 20, 2020

Uh oh!

Uh oh!